home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / SourceCode / AdobeExamples / NX_Scroll / README < prev    next >
Encoding:
Text File  |  1992-12-19  |  2.5 KB  |  50 lines
  1.  
  2. README file for the Scrolling application.
  3.  
  4. The Scrolling application looks at a variety of drawing issues. These include efficient
  5. path construction, use of the user path cache, setting graphic state parameters and
  6. drawing only that which is necessary. The Scrolling application can read a "distilled"
  7. PostScript file (one that is in a prescribed format) and place the graphic components into
  8. data structures for efficient display. The data structure consists of a list of graphics, with each
  9. graphic holding the path, its display parameters (line width, color, etcs) and whether the path
  10. should be stroked or filled. When a section is drawn, the list is traversed and the graphics
  11. are drawn.
  12.  
  13.  
  14. Below lies an annotated list of the files used in the application. 
  15.  
  16. ScrollingApp        - A subclass of Application. Creates the window with the
  17.                     ScrollView, DocView and DrawingView. Provides the
  18.                     id's of the items in the Drawing Options Panel (matrices, buttons, etc).
  19. DocView            - A subclass of View. Serves as the DocView for the ScrollView.
  20.                     Makes the DrawingView a subview making it easier to
  21.                     size and scale the DrawingView. The Drawing View is
  22.                     resized whenever the user zooms into or out of the
  23.                     document.
  24. DrawingView        - A subclass of View. The view manages the drawing. It cycles
  25.                     through the list of graphic objects messaging each one to
  26.                     draw itself in turn. It provides a large UPath structure for each
  27.                     graphic to use instead of having each graphic keep one on hand
  28.                     or mallocing one each time drawing occurs.
  29. Graphic            - A sublcass of Object. Holds the path and graphic state parameters
  30.                     for a single component of the drawing.
  31.  
  32. DrawingViewWraps    - Wraps for timing, obtaining ucache information and setting parameters.
  33.  
  34.  
  35. EpsfParser.m        These files parse an EPS file first verifying it as EPS and then as
  36. lex.l                a distilled file. The parsing acts as a rudimentry interpreter placing
  37. ierror.c            items on the stack and the popping them. A new graphic object is
  38. iinterpreter.c        created whenever a stroke or fill occurs when parsing. When this 
  39. iintrepreterhooks.m    happens, the current graphics state and the current path in this
  40. iparser.c            simple interpreter are installed in the new graphic object.
  41. iparserhooks.m
  42.  
  43.  
  44. Topics of interest from the Scrolling application:
  45.  
  46. Path construction and display (DrawingView, Graphic)
  47. Parsing a PostScript file - distilled format (EpsfParser.m, ierror, iinterpreterhooks,
  48.             iinterpreter, iparserhooks, iparser, lex)
  49. Scaling the view (DocView, DrawingView)
  50.